home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / programming / other / flexcat / developer.readme next >
Text File  |  1999-06-14  |  3KB  |  75 lines
  1.  
  2. Hello,
  3.  
  4. here you find the source code for the FlexCat.  It shall be fully
  5. portable and you should find no problems compiling it on the other
  6. platforms. Unfortunately there are at least two things which
  7. have to be made before you reach fully functional version FlexCat on
  8. your non-amiga system. 1st, the most importatant one, is the catalog
  9. handling system. All source descriptors use AmigaOS system calls
  10. (locale.library or, in version for OS2.0, iffparse.library), so to
  11. make FlexCat compiled, we'd need the plain ansi IFF parser. However
  12. it's very simple to be made (you just need to make FORM parser),
  13. I don't have enough time (nor needs ;-) to make my own. If you want
  14. to have FlexCat ported, you will have to write it yourself (remember,
  15. write source descriptor NOT the separate code!). And don't forget
  16. to send me you contribution -> I'd gladly enclose it in next release.
  17. The second thing you should be aware of, is the BigEndian versus
  18. LittleEndian problem. It needs deeper investigation, but I expect
  19. recent FlexCat to make incorrect catalog files when (theoreticaly)
  20. run on LittleEndian systens - stay careful). 
  21.  
  22.  
  23.  
  24. Why did I release it?
  25. ---------------------------------------------------------------------
  26.  
  27. Formerly FlexCat was covered by GPL license, so it's now back to the root
  28. somehow (I don't care all these GPL.readme etc files for now, so treat this
  29. all as freeware with source code available than GPL rather ;-).  Moreover
  30. few people asked about the version for other platforms (for many reasons),
  31. so now, having the source, you can compile it on whatever platform you
  32. need (but read above notes).
  33.  
  34. I am now busy with other Amiga projects, and as FlexCat seems to be almost
  35. finished (see TODO file), I don't plan to put much development in this
  36. project recently (it works quite fine, so I see no big need to do so
  37. anyway).
  38.  
  39.  
  40.  
  41. Do you have some ideas or features you would like to see in FlexCat?
  42. ---------------------------------------------------------------------
  43.  
  44. If you got any programming skill (no beginners pliz!) and some spare
  45. time you can add whatever you want.
  46.  
  47. But please don't release FlexCat yourself! Please send me diff output
  48. (or the whole source) with description of your changes -> I'd integrate it
  49. in next release myself.  I just want to prevent anyone from duplicating
  50. others' work (mail me if you want to develope FlexCat!).
  51.  
  52.  
  53.  
  54. Compiling FlexCat   
  55. ---------------------------------------------------------------------
  56.  
  57. There's SAS/C makefile enclosed (smakefile), so if you own SAS/C just type
  58. 'smake' to have FlexCat compiled.  Using other compilers should also be
  59. very easy. 
  60.  
  61. NOTE:  The source archive contains files which are not present in other
  62.        archives of FlexCat distribution. To make FlexCat compile, you 
  63.        will have to fetch #?.cd file (FlexCat_CatSrc.lha) as well as
  64.        FlexCat itself (may be any of previous releases).
  65.  
  66. NOTE2: if you want to compile FlexCat on non Amiga box, make sure there's
  67.        no  "__amigaos" defined (see the source). This would disable all
  68.        AmigaOS native parts (few, but they are), like catalog flushing etc,
  69.        which you won't find useful on non Amigas anyway.
  70.  
  71.  
  72.  
  73. Marcin Orlowski <carlos@amiga.com.pl>
  74. Wed May 19 11:53:17 1999
  75.